home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / putq.z / putq
Encoding:
Text File  |  2002-10-03  |  3.2 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ppppuuuuttttqqqq((((DDDD3333))))                                                              ppppuuuuttttqqqq((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_uuuu_tttt_qqqq - put a message on a queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _pppp_uuuu_tttt_qqqq_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_,,,, _mmmm_bbbb_llll_kkkk______tttt _****_b_p_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _q         Pointer to the queue.
  18.  
  19.      _b_p        Pointer to the message.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _pppp_uuuu_tttt_qqqq is used to put messages on a queue after the _pppp_uuuu_tttt(D2) routine has
  23.      finished processing the message.  The message is placed after any other
  24.      messages of the same priority, and flow control parameters are updated.
  25.      The queue's service routine is scheduled if it has not been disabled by a
  26.      previous call to _nnnn_oooo_eeee_nnnn_aaaa_bbbb_llll_eeee(D3), or if the message being enqueued has
  27.      greater than normal priority (that is, it is not in band zero).
  28.  
  29.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  30.      _pppp_uuuu_tttt_qqqq returns 1 on success and 0 on failure.
  31.  
  32. UUUUSSSSAAAAGGGGEEEE
  33.      _pppp_uuuu_tttt_qqqq can fail if there is not enough memory to allocate the accounting
  34.      data structures used with messages whose priority bands are greater than
  35.      zero.
  36.  
  37.    LLLLeeeevvvveeeellll
  38.      Base or Interrupt.
  39.  
  40.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  41.      Does not sleep.
  42.  
  43.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  44.      across calls to this function.
  45.  
  46.    EEEExxxxaaaammmmpppplllleeeessss
  47.      See _dddd_aaaa_tttt_aaaa_mmmm_ssss_gggg(D3) for an example of _pppp_uuuu_tttt_qqqq.
  48.  
  49. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  50.      _gggg_eeee_tttt_qqqq(D3), _iiii_nnnn_ssss_qqqq(D3), _mmmm_ssss_gggg_bbbb(D4), _pppp_uuuu_tttt(D2), _pppp_uuuu_tttt_bbbb_qqqq(D3), _qqqq_uuuu_eeee_uuuu_eeee(D4), _rrrr_mmmm_vvvv_qqqq(D3),
  51.      _ssss_rrrr_vvvv(D2)
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.